home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Diamond Collection
/
The Diamond Collection (Software Vault)(Digital Impact).ISO
/
cdr11
/
ac4paf14.zip
/
AC4PAF14.DOC
next >
Wrap
Text File
|
1995-01-24
|
28KB
|
792 lines
Ancestors and Cousins
for
Personal Ancestral File (tm)
Version 1.3 (October 1994)
by
Frank E. Hutchison
Personal Ancestral File and PAF are registered trademarks of the
Corporation of the President of The Church of Jesus Christ of
Latter-Day Saints.
Page 1
╔═════════════════════════════════════╗
║ ║
║ Ancestors and Cousins ║
║ for ║
║ Personal Ancestral File ║
║ (PAF) ║
║ by ║
║ Frank E. Hutchison ║
║ ║
╚═════════════════════════════════════╝
Ancestors and Cousins for Personal Ancestral File (AC4PAF) is
a program that will create a list of relatives for an individual
from the information found in a PAF database that contains that
person. The person's parents, spouse(s), children, grandchild,
nepfews, aunts, grandparents, etc. are shown on the screen,
printer, or a user-designated file. AC4PAF works only with PAF
databases containing INDIV2.DAT, MARR2.DAT, NAME2.DAT. Other files
of PAF are not used nor are GEDCOM files.
Using AC4PAF is a three-part process:
1) Tell the program where the PAF database is located,
2) Tell the program where the output is to go, and
3) Tell the program who.
STARTING AC4PAF
---------------
To start AC4PAF, type at the prompt either
C:\>AC4PAFxx
or
C:\>AC4PAFxx [location]
where the xx indicates the version number and [location]
indicates the location of the PAF data files, which is optional.
The title screen will appear. If the [location] was not
specified on the command line, then AC4PAF asks
Where is the PAF database located?
1. A:
2. B:
3. C:\PAF\DATA
4. Other
5. Return to System
Menu selection is made by selecting the menu number or using the
up and down arrow keys and hitting the <Enter> key.
Page 2
The first three choices will encompass probably 90% of the
locations of PAF databases. If yours is not one of the first
three choices, then select option 4. Just below the above menu
will be displayed:
Location of PAF database:
You can type in the path to the database. If it is wrong, an error
message will be displayed and you will be able to try again.
Option 5 will quit the program.
OUTPUT SELECTION
----------------
Now the second menu appears and asks:
What is the location of the output?
1. Screen
2. Printer
3. File
4. Change directory
0. Return to System
1. Screen
----------
Option #1 results in the relatives list being displayed on the
screen. This is best used to see the output BEFORE printing or
creating a file. There is no provision for "paging" through the
display, so the names may "fly" by, too fast to read.
2. Printer
-----------
Option #2 results in the relatives list being sent to the
printer, although they will also be displayed on the screen. The
default printer is assumed to be Epson compatible,
however, the only special control sent to the printer is the
command for compressed print on and off (normally 17 Characters Per
Inch (CPI)).
If you select option #2, then another menu will appear. This
menu allows you to change the way the work sheet will be printed
and adjust the codes for compressed printing if your printer is not
Epson compatible. This menu looks like:
Page 3
Output to the printer will be:
0. Proceed to print
1. Compressed (toggle) Not compressed
2. Compressed ON printer code \015
3. Compressed OFF printer code \018
4. Top margin 6 lines
5. Bottom margin 6 lines
6. Left margin 0 spaces
7. Right margin 0 spaces
8. Paper height 66 lines
9. Paper width 80 spaces
P. Print notes (toggle) Print notes
S. Save configuration
See Appendix I for details about changing the values shown and
creating new default values. For now, choose the first option,
zero (0), as it should work with a majority of printers.
3. File
--------
Option #3 will result in the creation of a file containing the
relatives list. If you select this option, you will be asked:
Location and name of file:
AC4PAF does check what it is given for a file name and path. If
the file already exists, you will be asked if you want to over
write it. If you do not enter a file name (just hit the Return or
Enter key, without entering any name), then the file will be named
PRINT.DAT and placed in the same directory or subdirectory as
AC4PAF.
4. Change directory
--------------------
Option #4 allows you to return to the previous menu to change
the directory.
0. Return to System
--------------------
The fifth option, zero (0), will end the program and return
you to the system prompt.
Page 4
IDENTIFY STARTING INDIVIDUAL
----------------------------
The third menu asks:
Identify Starting Individual
1. Know RIN
2. Do not know RIN
3. Input File
4. Change Output
0. Return to System
1. Know RIN
------------
Option 1 will ask: Which RIN? Type in the RIN. The RIN you
have entered will be checked, the individual information displayed,
and you will be asked if it's the correct individual. If it is the
correct individual, then AC4PAF will proceed to generate the
relatives list.
2. Do not know RIN
-------------------
Option 2 allows you to find an individual's RIN by entering
information about the individual and then searching the PAF
database for that individual. This is similar to the way PAF finds
an individual when the "Match names and positions during individual
search" option in CONFIG is chosen. Option 2 will display the
following
Individual Search
=================================================================
Surname: Given1: Sex:
Given2: Given3: Title:
-----------------------------------------------------------------
Birth date:
Place1: Place2:
Place3: Place4:
-----------------------------------------------------------------
Christening date:
Place1: Place2:
Place3: Place4:
-----------------------------------------------------------------
Death date:
Place1: Place2:
Place3: Place4:
-----------------------------------------------------------------
Burial date:
Place1: Place2:
Place3: Place4:
=================================================================
Page 5
You can enter as much or as little information you wish. You can
move around the screen using the Enter, Tab, Shift-Tab, Up and Down
Arrows and end the input by pushing the F1 key to start the search
or the F2 key to quit. This is the same as PAF. Names are checked
when you enter them to insure they are in the NAME2.DAT file.
3. Input File
--------------
Option #3 allows you to access a ASCII file, also called a DOS
text file or a non-document file. AC4PAF will expect one RIN to be
on each line of the file. This RIN will be read and acted upon as
if you typed it in. This is useful when you have a lot of
individuals you want relatives lists for. An example of such a
file would look like with three RINs:
516
14
5
^
This is column 1
Please note that ALL the output will go to the destination you
choose. If it's to file, it will all be in the same file.
4. Change Output
-----------------
Option #4 returns you to the previous menu that determined
what mode of output the program would generate.
0. Return to System
--------------------
The fifth option, which is zero (0), will end the program and
return you to the system prompt.
CREATION OF THE RELATIVES LIST
------------------------------
Now AC4PAF creates the relatives list. An sample is show
below:
Relatives of Mary Lynn EVANS
Children
1. Harold Christopher HUTCHISON (1975-)
2. Emily HUTCHISON (1978-)
3. Richard Charles HUTCHISON (1979-)
4. Meredith HUTCHISON (1983-)
There are 4 Children
Page 6
Parents
Siblings
Nieces and Nephews
GrandParents
Aunts and Uncles
Great GrandParents
.
.
.
.
Twelvth Great GrandParents
Twelvth Great Aunts and Uncles
186. Thomas FARRINGTON (1561-)
187. Reding F. FARRINGTON (1563-)
188. John FARRINGTON (1567-)
There are 3 Twelvth Great Aunts and Uncles
The order that the relatives list is created is:
1. Descendants
2. Parents and all their descendants
3. Grandparents and all their descendants
4. Great Grandparents and all their descendants
5. etc.
A person will appear only once in the list. Therefore, if you have
a situation where your ancestors were cousins who married cousins,
their descendants will appear only once - in the earliest position
as determined by the order above.
After the list is complete, AC4PAF will compile an index of
names with their relationship:
Index of Names
, Alice - 12ggm
, Mrs - 8ggm
AESCHER, Margretha - 5ggm
EGGEN, Jakob - 5gu
EGGEN, Jakob - 6ggf
WANGSGARD, Christian - 2gu
ZWAHLEN, Suzanna Katharina - 2ggm
TROUBLESHOOTING
---------------
AC4PAF is designed to handle 80 generations of ancestors or
descendants and 20 generations of cousins. If you exceed these
limits, I'm envious and you'll have to contact the author to get a
version which will handle more generations. Also, AC4PAF does not
have a lot of error trapping built into itself. If you have a
Page 7
problem with AC4PAF, beyond having too many gnerations, please try
the following suggestions to solve the problem:
1. Is the printer on? Does it have paper?
2. Is the directory identified for the PAF database correct?
3. If you are sending a file to disk, is there enough disk space?
If none of the above solves your problem, then please contact the
author (address on the last page) with the following information:
1. Where in the program the problem occurs.
2. A copy of any print out available.
3. A copy of the screen dump (press the Print Screen button with
the printer on).
4. A description of your computer (PC, XT, AT, 386, 486, etc.),
amount of memory, monitor, and video, as well as, your printer
type.
AC4PAF only READS and does not write to PAF files. There
should be no disruption of your PAF data files by AC4PAF. However,
it is good practice to ALWAYS have a back-up of your data whenever
you use a new program and especially after you have added to or
changed any information in your database.
APPENDIX I
How to "Configure" AC4PAF
The menu, shown below, that appears whenever output to the
printer is selected, along with the current values of each
parameter, allows the user to change those parameters which affect
how the printout will look on paper. The menu is:
Output to the printer will be:
0. Proceed to print
1. Compressed (toggle) Not compressed
2. Compressed ON printer code \015
3. Compressed OFF printer code \018
4. Top margin 6 lines
5. Bottom margin 6 lines
6. Left margin 0 spaces
7. Right margin 0 spaces
8. Paper height 66 lines
9. Paper width 80 spaces
P. Print notes (toggle) Print notes
S. Save configuration
Your printer manual should have an explanation of normal values for
your printer. An explanation of each option on the menu follows:
Page 8
0. Proceed to print
--------------------
This option tells AC4PAF that you are satisfied with the
current values and to proceed to the next menu, the "Identifying
Starting Individual" menu.
1. Compressed (toggle)
-----------------------
This option is a toggle. Selection of this option will change
from "Compressed" to "Not compressed" and vice versa.
2. Compressed ON printer code
------------------------------
This option allows you to change the codes used by AC4PAF to
start compressed printing. The codes are displayed as their ASCII
equivalents. For example, the ASCII equivalent of the Escape code
(the Esc key on your keyboard) is 27.
You can enter up to five individual codes. When this option
is selected, you will be prompted for each individual code
separately, i.e.
First printer code:
For Epson compatible printers, the code for compressed print is 15.
Therefore, you would enter 1 and 5 followed by <Enter>. Then, you
would be prompted for the second printer code:
Second printer code:
If there was a second code, you would enter it just like you did
for the first printer code. In this case, since there isn't one,
you just hit the <Enter> key, the codes you have entered will be
displayed, and you can make another selection.
3. Compressed OFF printer code
-------------------------------
This option operates exactly like the Compressed ON printer
code, except the codes entered are for turning compressed printing
off.
4. Top margin
--------------
This option allows you to change how many blank lines will be
put at the top of each page. Selection of this option will result
in the prompt:
Number of lines for top margin:
Just enter the number of blank lines you want. Usually 6 lines
equal one inch.
Page 9
5. Bottom margin
-----------------
This option is the same as the Top margin except it's for the
bottom margin.
6. Left margin
---------------
This option allows you to change how many blank spaces will be
put at the left of each line. Selection of this option will result
in the prompt:
Number of spaces for left margin:
Just enter the number of spaces you desire.
7. Right margin
----------------
This option is the same as the Left margin except it's for the
right margin. THIS OPTION IS IMPLEMENTED.
8. Paper height
----------------
This option allows the user to tell AC4PAF how many lines per
page there are so that AC4PAF will know when to apply the top and
bottom margins. You will be prompted with:
Number of lines for paper height:
Usually there are 66 lines to a page with normal print.
9. Paper width
---------------
This option allows the user to tell AC4PAF how many spaces per
line there are so that AC4PAF will know where to apply the right
margin. You will be prompted with:
Number of spaces for paper width:
Usually there are 80 spaces to a line with normal (pica) print, 96
with elite print, and 136 spaces with compressed print on a eight
inch wide paper.
P. Print notes (toggle)
------------------------
This option is a toggle. Selection of this option will change
from "Print Notes" to "Notes not printed" and vice versa.
S. Save configuration
----------------------
This option will save all the values displayed in a file named
AC4PAF.CFG in the PAF directory that is currently selected.
AC4PAF.CFG is an ASCII file that can be edited using any text
editor or word processor in non-document mode, however, using
AC4PAF will be the easiest way of modifying AC4PAF.CFG.
Page 10
AC4PAF will look for AC4PAF.CFG once the PAF directory has
been identified. If AC4PAF.CFG is present, then the values will be
read in and replace the default values in AC4PAF.
VERSIONS
--------
Version 1.0 (AC4PAF10): The original program. Released September
1993.
Version 1.1 (AC4PAF11): Corrects the prefix for aunts and uncles
beyond the first generation and the
number of "times removed" with cousins.
Released October 1993.
Version 1.2 (AC4PAF12): Corrects the calculation of cousins
removed and the starting position of the
second (and later) run when output is
printed. Released October 1994.
Version 1.3 (AC4PAF13): Corrects a problem with directing output
to a file (output could only be placed
in the same directory as the PAF data).
File can now be placed wherever desired.
Version 1.4 (AC4PAF14): Removes a previous limit on the number of
times removed. Also allows use of EMS
memory, if it's available, for creating
the index.
APPENDIX II
Personal Ancestral File and PAF are registered trademarks of the
Corporation of the President of The Church of Jesus Christ of
Latter-Day Saints.
All rights to AC4PAF and its accompanying files are reserved.
AC4PAF may be distributed and used only in accordance with the
provisions contained herein. Comments, problem reports and
suggestions for improvements are welcomed and may be sent to:
Address: Frank E. Hutchison
Snail mail:
Until July 1995: 209 Waller Mill Rd, Williamsburg, VA 23185
After July 1995: 5108 Richardson Dr., Fairfax, VA 22032
CompuServe: 73014,2566
Anyone who first reports a problem or suggests an improvement will
receive the first copy of the improved program free.
I also monitor the GENSOFT echo on the Fidonet for messages to
Frank Hutchison. Please note that I do not use my middle initial
and please note that Hutchison is not HUTCHINSON. Thank you.
REGISTRATION
------------
If you use Ancestors and Cousins for Personal Ancestral File
(AC4PAF) you are asked to register with me. The cost is FIVE
dollars ($5.00). This will (1) increase my high regard for you,
(2) encourage me to improve the program, (3) allow me to inform you
of improvements, (4) allow me to notify you in the event that a
serious problem with AC4PAF is discovered, and (5) convince my wife
that I'm not just playing with the computer.
╔═════════════════════════════════════╗
║ ║
║ Ancestors and Cousins ║
║ for ║
║ Personal Ancestral File ║
║ (PAF) ║
║ by ║
║ Frank E. Hutchison ║
║ Version 1.2 ║
║ ║
╚═════════════════════════════════════╝
REGISTRATION FORM
Surname: _____________________ Given1: _____________________
Given2: ______________________ Given3: _____________________
Address1: __________________________________________
Address2: __________________________________________
City: _____________________________________________
State: __________ Zip Code: ________________
Phone: (_____) ________--_______________
How did you find out/acquire Ancestors and Cousins for Personal
Ancestral File (AC4PAF)?
Comments/Suggestions/Problem Report:
Mail to: July 1995 After July 1995
Frank E. Hutchison Frank E. Hutchison
209 Waller Mill Rd. 5108 Richardson Dr.
Williamsburg, VA 23185 Fairfax, VA 22032